PsL Monthly 1993 December

home *** CD-ROM | disk | FTP | other *** search

/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / c / maker.com / MAKER.DOC < prev next >

Wrap

Text File | 1991-06-09 | 19.5 KB | 453 lines

████████████████████ ██ ██ ██ Maker ██ ██ ██ ██ Version 1.02 ██ ██ ██ ████████████████████ ┌───────────────────────────────────────────────────────────────┐ │ GENERAL │ └───────────────────────────────────────────────────────────────┘ This program generates MAKE description files & LINK files. It designed for the Microsoft C compiler, but has enough generality to be useful with other compilers as well. To use the program, enter: MAKER [files] [options] files The source code files to process. They must be in the current directory. Wild cards (* and ?) are OK. The default is *.C. Options: /Ccmd The compilation command. The default is "CL /c". If the command has embedded spaces, enclose the entire argument in double quotes. /Dfile The MAKE description file name. The default is for the output file to be in the current directory, with the same name as the first source code file & an extension of "MAK." /Efile Is the executable file name. The default is the base name of the first source code file, with an extension of "EXE." /Lfile Is the LINK file name. A LINK file contains commands passed to the linker, & is invoked by LINK @filename. The default file name, is the base name of the first source code file, with an extension of "LNK." /ND Don't produce a MAKE description file ("no description file") /NL Don't produce a LINK file ("no LINK file") /Oopts Link options. If the options have embedded spaces, enclose the entire argument in double quotes. /P Makes the program proceed even if it encounters errors reading a particular include file. The default is to show an error message & abort. If you use /P, an error message is still shown, but the program continues; it also includes an error notice in the MAKE description file. This parameter is especially useful if you are creating the MAKE description file for the first time and have a large number of source code files. Using /P prevents you from having to rerun the program repetitively to correct missing include files. You can run it once, correct any errors, then run it a second and final time. /Vvar The environment variable telling where additional include files may be found. The default is /VINCLUDE. This option is useful if you put your include files in a separate directory. /Xpre Ignore include files except those start with the specified prefix. The default is to process all include files. One use for the /X option is to ignore include files which are part of the standard library & thus never change. To use the /X option this way, all other include file names would have to have a standard prefix. You may repeat the /X option as many times as needed. Prefixes must be no more than eight characters long. EXAMPLE: MAKER TEST?.C "/CCL /Od /Zi" /ETEST.EXE /OST:4000 /P /XFH /XRWA ┌───────────────────────────────────────────────────────────────┐ │ HOW THE PROGRAM WORKS │ └───────────────────────────────────────────────────────────────┘ Maker reads each source file, one at a time, to find what files it includes. It then reads each include file to see it it has any further include files. It displays the source file names as it proceeds, then the include files, indented two spaces. If an include file has further include files, those will be further indented, in a nested hierarchy. The program assumes that all include files are in the same directory as the source code files, or in directories specified by the environment variable. If an environment variable is used, separate directory paths with semicolons. For example, the following environment variable: INCLUDE=C:\C\INC;\FH\INC causes Maker look for source code files in the current directory, plus the directories C:\C\INC & \FH\INC. When Maker finishes, you have both a MAKE description file and a LINK file (unless you used /ND or /NL). You may have to do some additional editing on the files, if you want them in some other format, or have additional items to add. But the hard part--defining the dependencies--has been done. ┌───────────────────────────────────────────────────────────────┐ │ LIMITATIONS │ └───────────────────────────────────────────────────────────────┘ ■ Maker was originally written for Microsoft C files. However, it can be customized to some extent to accommodate other compilers as well. The program requires MS-DOS or PC-DOS, version 2.0 or later. ■ Source code lines must be 511 characters or less. ┌───────────────────────────────────────────────────────────────┐ │ SYSTEM REQUIREMENTS │ └───────────────────────────────────────────────────────────────┘ Maker requires MS-DOS or PC-DOS, version 2.0 or later. ┌───────────────────────────────────────────────────────────────┐ │ EXIT CODES │ └───────────────────────────────────────────────────────────────┘ Maker reports the following exit codes. You can use these with the ERRORLEVEL function in batch files (see your DOS manual for details). 0 Normal termination 1 User aborted 2 Non-fatal error occurred during processing 3 Fatal error ┌───────────────────────────────────────────────────────────────┐ │ WHAT'S IN THIS PACKAGE │ └───────────────────────────────────────────────────────────────┘ This package contains the following files: MAKER.EXE Main program MAKER.DOC Documentation REGISTER.DOC Registration form CATALOG.DOC Catalog of other software available ┌───────────────────────────────────────────────────────────────┐ │ REVISION HISTORY │ └───────────────────────────────────────────────────────────────┘ 1.00 Original program 1.01 Fined tuned code to make it more compact Fixed bug so program would run on 8088 machines 1.02 Fixed minor bugs ┌───────────────────────────────────────────────────────────────┐ │ MESSAGES │ └───────────────────────────────────────────────────────────────┘ Can't close file XXXXXX. DOS wouldn't close the specified file, so the contents are probably invalid. Can't find environment variable XXXXXX. You specified a variable with /V that is not in the current environment. Can't open file XXXXXX. DOS couldn't read the specified file. This usually has one of two causes. First, there may be too many files being open. This usually indicates to many levels of include nesting. If this happens, try increasing the FILES= statement in your CONFIG.SYS file. If this doesn't solve the problem, try rearranging your include file structure so it isn't so heavily nested. A second possible cause, if the file is an output file, is that a previous version existed & is read only. Can't read file. The program couldn't find the file. Check your environment variable to make sure it specifies the correct directory. If you want the program to proceed despite this type of error, use /P. DOS 2.0 or later required. You need PC-DOS or MS-DOS, version 2.0 or later. Include file prefix too long. It must be 8 characters or less. Insufficient memory. Try deinstalling your RAM disk, TSR programs, or getting more memory. Integer divide by 0. This indicates a possible program bug. Contact the author and tell him the circumstances under which you saw this message. Invalid argument. Check the instructions for the correct syntax. Invalid include directive: XXXXX. Include file names must be enclosed with angle brackets (<>) or double quote marks (""). The source code file that contains the invalid directive is shown one or more lines above the error message. Not enough space for arguments. You need more memory to run the program. Not enough space for environment. You need more memory to run the program. Null pointer assignment. This indicates a possible program bug. Contact the author and tell him the circumstances under which you saw this message. Program aborted. You pressed Ctrl-Break or Ctrl-C, or asked the program not to overwrite an existing file. Source files must be in current directory. You specified a different drive or directory. Stack overflow. Either your include file nesting is too complex, or you have circular inclusions (i.e., File A includes file B, which includes File A, which includes File A, etc.). ┌───────────────────────────────────────────────────────────────┐ │ MISCELLANY │ └───────────────────────────────────────────────────────────────┘ You can redirect the keyboard input if desired. This is especially useful when updating description & LINK files in the batch mode. As an example, try the following: ECHO YY | MAKER ┌───────────────────────────────────────────────────────────────┐ │ CREDITS │ └───────────────────────────────────────────────────────────────┘ Maker was written in C by Richard W. Adams. It was developed with PC-Write, version 3.02, & the Microsoft C Optimizing Compiler, version 5.1. The author is a member of the Association of Shareware Professionals (ASP). You may reach him at the address given in REGISTER.DOC. Should that address no longer be valid, try contacting him through the ASP (545 Grover Road, Muskegon, MI 49442). He is also sometimes available on CompuServe (76430,1071). ┌───────────────────────────────────────────────────────────────┐ │ REGISTRATION │ └───────────────────────────────────────────────────────────────┘ Maker is copyright 1991 by Richard W. Adams, all rights reserved. The program is "shareware." If you use Maker for more than 30 days, you must register. To do so, complete the registration form in REGISTER.DOC & send it with a check for the indicated amount to the author at the address on the form. When you register, you receive: o The right to use your copy of Maker on a single computer. o Free technical support by mail for three months. o Eligibility for free copies of future versions if you're the first to suggest improvements or report bugs that are fixed/incorporated in future versions. Not only is registration a legal & ethical requirement, but registration fees give shareware authors the incentive to develop new software & improve old ones. Tax exempt Christian religious organizations & churches are eligible for free registration of Maker for official business. Send a written request to the author, & you'll receive registration forms. The registration takes effect when you complete return the forms. This is a charitable donation. Companies, government agencies & other organizations may obtain site licenses for Maker, at greatly reduced unit costs. Contact the author for details & a price list. ┌───────────────────────────────────────────────────────────────┐ │ SHAREWARE │ └───────────────────────────────────────────────────────────────┘ Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details--some request registration, others require it, and some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee--if you don't use the product, you don't pay for it. DISCLAIMER - AGREEMENT Users of Maker must accept this disclaimer of warranty: "Maker is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of Maker." Maker is a Shareware program and is provided at no charge for your evaluation. Feel free to share it with your friends, but please don't give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find Maker useful and continue to use it after a reasonable trial period, you must make a registration payment of $10.00 to the author. The $10.00 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that any number of people may use this software and may freely move it from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as two different people can't read a book at the same time. Commercial users of Maker must register and pay for their copies of Maker within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting the author. Anyone distributing Maker for any kind of remuneration must first contact the author for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering Maker immediately. (However, you must still advise the author so the distributor can be kept up-to-date with the latest version of Maker.) You are encouraged to pass a copy of Maker to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. ┌───────────────────────────────────────────────────────────────┐ │ COPYING │ └───────────────────────────────────────────────────────────────┘ You may copy & distribute Maker freely, as long as you: o Don't distribute it for commercial purposes without written permission from the author. o Don't rent or lease it. o Include all constituent files. o Don't change the software or documentation. o Charge no fee other than a nominal one to cover distribution costs. ┌───────────────────────────────────────────────────────────────┐ │ OMBUDSMAN │ └───────────────────────────────────────────────────────────────┘ The author is a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you can't resolve a shareware related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe mail message to the ASP Ombudsman (70007,3536). _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.